Cream of the Crop 12

home *** CD-ROM | disk | FTP | other *** search

/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / OS2 / STPOS2.ZIP / stpos2.inf (.txt) < prev next >

Wrap

OS/2 Help File | 1996-03-15 | 22.9 KB | 637 lines

ΓòÉΓòÉΓòÉ 1. Managing Subdirectories with STP ΓòÉΓòÉΓòÉ Subdirectory Tree manager Plus for OS/2 (STPOS2) is a subdirectory management program for an IBM PC compatible computer. It displays a picture of the subdirectory structure of a disk, and provides a variety of utilities that can be used to manipulate that structure. STPOS2 also allows you to look at and negotiate the subdirectories on a disk by moving a reverse video "subdirectory cursor". The utilities of STPOS2 can be accessed using the left and right arrow keys to highlight a desired function. These functions include: current Dir Change the current directory. See the note in current Dir. Copy Copy a directory including it's files, copy all the files in a directory, or copy some of the files in a directory. This copy can occur on the same drive or between drives. Move Move a directory including it's files, move all the files in a directory, or move some of the files in a directory. This move can occur on the same drive or between drives. Add Add a subdirectory to the tree. reName Rename an existing subdirectory. Erase Erase a directory including it's files, erase all the files in a directory, or erase some of the files in a directory. Information A function that allows you to view information about the subdirectories on a disk. The information being the number of files in each directory or the amount of disk space consumed by the subdirectory. Pressing the enter key will execute the highlighted function. To quickly execute a non-highlighted function, you can simply press its capitalized letter. Several actions are also available via the function keys. Context sensitive help is available via the 'HELP' key (default PF1). ΓòÉΓòÉΓòÉ 2. Installing STPOS2 ΓòÉΓòÉΓòÉ This section describes the procedure for installing STPOS2 on an IBM PC compatible computer. STPOS2 is delivered with the following files in one zip file (e.g. STPOS2.ZIP). STPOS2 .EXE -- The STPOS2 program. STP .CMD -- A CMD file for running STPOS2 which allows STPOS2 to maintain a changed directory after exiting. STPOS2 .INF -- This file. STPOS2 .SAM -- The profile of the STPOS2 program as delivered. STPDEMO .SAM -- An alternative profile. STPPRO .CMD -- The 'profiler' for STPOS2. STPOS2_x.ICO -- Two different icons for STPOS2 (x = 1 or 2). Download STPOS2 ZIPBIN in binary mode to the PC (if obtained internally). STPOS2.EXE, STPOS2_x.ICO, STPOS2.INF, STP.CMD, and STPxxx.SAM can be extracted from STPOS2.ZIP via UNZIP.EXE or PKUNZIP 2.04g. Place STPOS2.EXE, STPPRO.CMD, STP.CMD and a copy of either STPOS2.SAM or STPDEMO.SAM in a directory defined by the PATH statement in your CONFIG.SYS. Rename this profile to a name you prefer (e.g. PERSONAL.PRO). You will edit this PERSONAL.PRO file with your personal preferences for STPOS2s colors, Alt, and Ctrl PFKey behavior. Place STPOS2.INF in a directory defined by the BOOKSHELF statement in your CONFIG.SYS. View each icon (STPOS_x.ICO) via 'drives' to determine which one you prefer. Rename the one you prefer to STPOS2.ICO and place it in the directory with STPOS2.EXE. Alternately, rename the one you prefer to STP.ICO and place it in the directory with STP.CMD, if you use STP.CMD to start STPOS2. To create an icon on the desktop, open the 'Templates folder', and drag a 'Program object' to the desktop. In the 'notebook' that subsequently opens enter 'd:\path\stpos2.exe' (where path is your path to STPOS2, and d: is the drive letter), then close the notebook. If you plan to use STP.CMD enter STP.CMD instead of STPOS2.EXE in the notebook. The following program is used by STPOS2 and is distributed as a separate item: FM0S2.EXE The FILEMAN program, which can be used from STPOS2 to allow the management of individual files within a subdirectory or files/directories over the same or several drives. Available in the FM0S2 PACKAGE. ΓòÉΓòÉΓòÉ 3. Using STPOS2 ΓòÉΓòÉΓòÉ When you start STPOS2 you will initially be shown a logo screen. This screen will go away as soon as STPOS2 knows what all your subdirectories are. While the logo screen is up you can watch the count of your subdirectories. STPOS2 will find and display all of the subdirectories on the disk you designate. Once inside STPOS2, you'll notice that the screen divides into three distinct sections. At the bottom of the screen there are two rows of function keys. In the middle of the screen there is a full screen rendering of the disks subdirectory structure. At the top of the screen there is a menu. Using these areas is, hopefully, straightforward. The top and bottom areas of the screen represent actions that can be taken with STPOS2. The middle screen area shows objects (subdirectories) that can be acted on. The function keys at the bottom of the screen are selected using the function keys on the keyboard. The menu items at the top of the screen are selected by either (a) using the left and right and keys to highlight a desired menu item and pressing the enter key or (b) typing the capitalized letter of the desired menu item. Once you select an action, subdirectories are selected using the enter key and a variety of cursor motion keys including the up, down, left and right arrow keys, the PgUP, PgDn, Home and End keys, and the Ctrl-Left and Ctrl-Right keys, as follows: ΓòÉΓòÉΓòÉ 3.1. Cursor Movement ΓòÉΓòÉΓòÉ Ten keys and key combinations can be used to move around the subdirectory structure of STPOS2 (Browse mode). Eight of these keys allow you to move around in a fairly conventional manner, much as you might in a spreadsheet or other field oriented application. These keys are: Left Move the subdirectory cursor left from a child to a parent. Right Move the subdirectory cursor right from a parent to a child. Down Move the subdirectory cursor down among siblings (children of the same parent) in the same column. Going down from the bottom subdirectory, will move the subdirectory cursor to the top subdirectory in that column. Up Move the subdirectory cursor up among siblings (children of the same parent) in the same column. Going up from the top subdirectory, will move the subdirectory cursor to the bottom subdirectory in that column. PgDn Move the subdirectory cursor down approximately one half screen to the highest level subdirectory on that line. PgUp Move the subdirectory cursor up approximately one half screen to the highest level subdirectory on that line. End Move the subdirectory cursor to the last subdirectory listed. Home Move the subdirectory cursor to the first directory listed (e.g. root). The Ctrl-Left and Ctrl-Right keys provide an alternative form of movement that can be used to rapidly move around the subdirectory tree. Ctrl-Right follows the chain of the subdirectory tree downward from one subdirectory to the next and one line to the next. It will highlight every subdirectory in the tree in a sequence that prefers movement from parent to child over movement from sibling to subsequent sibling, and prefers deep siblings to shallow ones. Ctrl-Left follows the chain of the subdirectory tree upward from one subdirectory to the previous and one line to the previous. It will highlight every subdirectory in the tree in a sequence that prefers movement from child to parent on the same line over movement from the shallowest subdirectory on a line to the deepest subdirectory on the previous line. ΓòÉΓòÉΓòÉ 3.2. Function Keys ΓòÉΓòÉΓòÉ Forty-eight function keys are available for use from within STPOS2. In addition to any external OS/2 command or program the following 'internal' STPOS2 commands are also available: HELP Supplies context sensitive help. You can get help from anywhere within STPOS2. REFRESH Allows you to refresh STPOS2s knowledge of the directory structure. This may be useful if you change the directory structure while "shelled" from STPOS2. This function is also available by pressing Ctrl-R. QUIT Quits the STPOS2 program. NEW TREE Allows you to switch the Tree display from one disk drive to another. Such switching can be performed at any time, including those times when you are specifying source and target subdirectories for the STPOS2 directory management operators. This function key is particularly powerful in the copy/move Directory and copy/move Files operations, as it allows you to copy/move directories/files between disk drives. FREE SPACE Displays the free space available on the current disk. COMMAND Executes a single OS/2 command from an OS/2 command line. VERSION Displays the current version of STPOS2. OS/2 SHELL Shells to OS/2 command line. To return to STPOS2 type EXIT from the OS/2 command line. ΓòÉΓòÉΓòÉ 3.3. The Menu ΓòÉΓòÉΓòÉ The menu is used in STPOS2 to give you a powerful set of subdirectory maintenance capabilities, several of which have already been briefly described. One of these menu items sits under a reverse video "menu cursor". This menu cursor can be moved from one item to another using the left and right arrow keys. As this reverse video cursor moves from item to item, a second line, which provides an extended one line description of the highlighted function, changes as well. If you wish to execute a highlighted option, you need only use the enter key. A single character in each menu item is capitalized. Typing this capitalized letter has the same effect as moving over to a menu item with the left and right arrow keys and pressing enter. The reverse video menu cursor is repositioned and the selected menu item is executed. This allows you to select menu items more quickly. If you aren't sure about a menu item, help is available by pressing the 'HELP' key (if you have installed STPOS2.INF as instructed in the last chapter). STPOS2 ships with F1 defined as the 'HELP' key. When you select a menu item, the subdirectory tree area becomes active. You will be prompted to select a subdirectory, given instructions on what you can do, or asked for other information. Simply follow the instructions. Cursor movement in the subdirectory area is fairly simple, and is fully documented in Cursor Movement. The menu contains eight main entries. Four of these entries have submenus. Overviews of these menu items follow: ΓòÉΓòÉΓòÉ 3.3.1. current Dir ΓòÉΓòÉΓòÉ The current subdirectory is the subdirectory whose contents would be displayed if you entered a DIR command with no options. It can be changed from the command line, using the CD command. It can also be changed from within STPOS2. It will generally be faster to change the current directory using the CD command. STPOS2 lets you look at your subdirectory structure and select a current directory interactively, however. This can be an advantage when you aren't quite sure what subdirectory you're after. Note: OS/2 doesn't allow a program to change the environment from which it was run. That means STPOS2 can't retain the modified current directory for you after it is exited. To get around this you can start STPOS2 via the STP.CMD file. If you change the current directory within STPOS2 and are running via STP.CMD, you will exit STPOS2 at the directory you changed to within STPOS2. ΓòÉΓòÉΓòÉ 3.3.2. Copy ΓòÉΓòÉΓòÉ STPOS2s copy option provides access to three forms of file and directory copying, each of which can be performed between subdirectory locations on the same disk, or on different disks: Directory Copies a directory and all its contents, including child subdirectories. When the operation is complete, you will have two copies of the directory. All files Copies all of the files within a directory to another directory. The directory is not copied, neither are any subdirectories it contains. The names of the files will be listed as they are copied. Selectively Copies files within a directory to another directory on a selective basis. When this option is selected, files are listed on the screen, and you decide whether or not the files should be copied. When selective copy is complete, files which you copied will be found in the target directory; all files will remain in the source directory. ΓòÉΓòÉΓòÉ 3.3.3. Move ΓòÉΓòÉΓòÉ STPOS2s move option provides access to three forms of file and directory movement, each of which can be performed between subdirectory locations on the same disk, or on different disks: Directory Moves a directory and all its contents, including child subdirectories. All files Moves all of the files within a directory to another directory. The directory is not moved, neither are any subdirectories it contains. The names of the files will be listed as they are moved. Selectively Moves files within a directory to another directory on a selective basis. When this option is selected, files are listed on the screen, and you decide whether or not the files should be moved. When selective move is complete, files which you moved will be found only in the target directory; files which you decided not to move will be found in the source directory. Note: Moving a subdirectories/files around on a hard disk may have side effects, see Side effects of moving and erasing directories and files. ΓòÉΓòÉΓòÉ 3.3.4. Add ΓòÉΓòÉΓòÉ The Add function allows you to add a new subdirectory to your subdirectory tree. The new subdirectory will be a child of the subdirectory you highlight when you executed the Add command. Hence if you wanted to add a CHILD subdirectory to the PARENT subdirectory, you would select the PARENT subdirectory, but if you wanted to add a PARENT directory to the main directory you would select the root. ΓòÉΓòÉΓòÉ 3.3.5. reName ΓòÉΓòÉΓòÉ The rename function allows you to change the name of any subdirectory in your subdirectory tree except the root directory (which doesn't have a name anyway). ΓòÉΓòÉΓòÉ 3.3.6. Erase ΓòÉΓòÉΓòÉ STPOS2s erase option provides access to three forms of file and directory deletion: Directory Erases a directory and all its contents, including child subdirectories and their contents. If the directory contains files, however, you must directly confirm that you wish to erase those files. If moreover, the directory contains subdirectories, you must make that confirmation twice. All files Erases all of the files within a directory. When the erasure is complete, only the subdirectory will remain. Selectively Erases files within a directory on a selective basis. When this option is selected, files are listed on the screen, and you decide whether or not the files should be erased. When selective erase is complete, the directory will remain along with any files you decided not to erase. Note: Erasing a subdirectories/files may have side effects, see Side effects of moving and erasing directories and files. ΓòÉΓòÉΓòÉ 3.3.7. Information ΓòÉΓòÉΓòÉ The STPOS2 information option allows you to view, for each subdirectory on the displayed drive, information about the number of files contained within that subdirectory, or number of bytes required to store those files. This information can be turned off with the Information Off option. STPOS2 rounds directory sizes to the nearest #.# Megabyte starting at .95M. Therefore 974K, which is approximately .95M is displayed as 1.0M. Values below 974K are displayed as ###K. ΓòÉΓòÉΓòÉ 3.3.8. Quit ΓòÉΓòÉΓòÉ This option quits from the current execution of STPOS2. ΓòÉΓòÉΓòÉ 3.3.9. Browse ΓòÉΓòÉΓòÉ A final function, not displayed in the STPOS2 menu, is Browse. You can move around (browse) the subdirectory tree at any time by pressing the up or down arrow keys. ΓòÉΓòÉΓòÉ 3.4. Performing a copy or move operation between two drives ΓòÉΓòÉΓòÉ The copy and move functions can be used copy/move a directory and/or files between two disk drives as follows: Select the directory you wish to copy or move to another drive. Press the F5 key to select the New Tree function. Select the other drive by writing the drive letter (a b c d ... ) and pressing the enter key. Select the target location on the other drive. If the copy or move is selective, select the files involved. ΓòÉΓòÉΓòÉ 3.5. Side effects of moving and erasing directories and files ΓòÉΓòÉΓòÉ The act of moving and erasing subdirectories and/or files can result in undesirable side effects, as it can change the workings of your path and of various batch files and routines. If you move or erase directories, be sure to check any path statements you may have built into your system (e.g. check CONFIG.SYS) and any batch files and routines that may be affected by the move or erase. ΓòÉΓòÉΓòÉ 4. Ctrl-B Key Operation ΓòÉΓòÉΓòÉ The Ctrl-B key is defined to 'reset' a fine OS/2 feature. If you run STPOS2 in a fullscreen and have a light background color defined, swtiching to the desktop (e.g. Ctrl-Esc) and returning to STPOS2 shows that background has swtiched from 'light' to 'blinking'. Ctrl-B will reset it to 'light'. ΓòÉΓòÉΓòÉ 5. Ctrl-F/P Key Operation ΓòÉΓòÉΓòÉ The Ctrl-P key is defined to print out the directory tree of the currently displayed drive. The Ctrl-F key is defined to create a file which contains the directory tree of the currently displayed drive. The file will be placed in the root directory of that drive and be called STPDRVd.LST (where d is the current disk drive letter). ΓòÉΓòÉΓòÉ 6. STPOS2 Configuration/Customization ΓòÉΓòÉΓòÉ The colors, control and PFKeys, and certain run time options of the STPOS2 program can be customized. The configuration process works from reading in a profile file. The profile file uses 'keywords' followed by background and foreground colors, PFKey titles and PFKey commands, and/or run time options. Two example STPOS2 profile files are supplied, they are STPOS2.SAM and STPDEMO.SAM. As supplied, STPOS2.SAM will return STPOS2 to the default configuration. I suggest you rename one of the xxx.SAM files to a_name_you_like.PRO and modify it to suit your personal preferences. There is no real order in the profile. If the configuration function does not recognize a word it ignores the line. For example, the header in the example profile STPOS2.PRO Topic Field Background Foreground ----------- ---------- ---------- is ignored and not necessary. ΓòÉΓòÉΓòÉ 6.1. Permanent Profiling ΓòÉΓòÉΓòÉ Permanent profiling modifies STPOS2.EXE. To get the STPOS2 program to perform a permanent configuration from a profile use the STPPRO.CMD file as shown in the example below: STPPRO STPOS2.PRO The profile, STPPRO.CMD and STPOS2.EXE should reside in the same directory, and that should be the current directory. Additionally, OS/2 doesn't allow a running program to be modified. It is, therefore, necessary to ensure STPOS2 is not running during the configuration process. STPOS2 will issue a message showing what it is profiling and what profile file it is using. ΓòÉΓòÉΓòÉ 6.2. Temporary Profiling ΓòÉΓòÉΓòÉ You may profile STPOS2 temporarily by using an environment variable. This method does not modify STPOS2.EXE. For this to function the STP_PRO environment variable must be set. This may be done in the CONFIG.SYS file or in a CMD file from which STPOS2 is run. For example: SET STP_PRO=D:\DIR1\DIR2\MYPROF.PRO For those that would rather not modify their CONFIG.SYS file, the same thing can be accomplished with a CMD file as shown: SET STP_PRO=D:\DIRA\DIRB\TEMPRO.PRO STPOS2 %1 %2 %3 %4 %5 %6 %7 %8 %9 You may, for example, call the CMD file STP2.CMD. You can then invoke STPOS2 via STP2 and pass any other input switches and/or file specifiers you wish. ΓòÉΓòÉΓòÉ 6.3. Profile Options ΓòÉΓòÉΓòÉ There are three main sections in the profile. The first is the colors to be used for the various parts of the display. The second section deals with the run time options available, and the final section in the profile defines the setting for the Ctrl, Alt, and normal PFKeys. ΓòÉΓòÉΓòÉ 6.3.1. Color ΓòÉΓòÉΓòÉ The colors available are: black blue green cyan red magenta brown lightgrey darkgrey lightblue lightgreen lightcyan lightred lightmagenta yellow white The actual areas of the screen whose colors can be changed are documented in Screen coloring. ΓòÉΓòÉΓòÉ 6.3.2. Run Time Options ΓòÉΓòÉΓòÉ DOSChar This is used to specify the character that is to appear before the prompt when STPOS2 is shelled to OS/2. EscapeToQuit This variable can have one of three values Yes, No, or Prompt. This controls the operation of the Esc key from with STPOS2. QuickDOS This can have one of two values Yes or No. When 'OS/2 SHELL' (default F10) is pressed to shell to OS/2, then an informative message is displayed if QuickDOS is No. This message is bypassed if QuickDOS is Yes. DirNameWidth This controls the length of the 'visibly displayed' portion of a directory name. This is primarily for HPFS drives where a directory name can be 1 to 256 characters. STPOS2 will only 'display' the first 'n' characters of that name, where n = DirNameWidth. This value can have a setting of 12 through 30 characters. Beep This controls whether or not STPOS2 beeps if you press an invalid key, or reach the end of a subdirectory path. Acceptable values for this are Yes or No. QuickKey This variable has Yes or No as its acceptable settings. This controls whether or not a 'Press any key ...' message appears after a Ctrl or Alt function key has been used. AlphaSort This variable has Yes or No as its acceptable settings. This controls whether or not the directories in the tree are displayed in alphabetical order. If the tree is displayed as found (AlphaSort No), then it can be shown sorted by pressing Ctrl-S. ShowHidden This variable has Yes or No as its acceptable settings. This controls whether or not hidden directories in the tree are displayed. The key combinations Ctrl-H and Ctrl-U are used to hide and unhide the directories. A hidden directory is identified by a capital H following the directory name. ΓòÉΓòÉΓòÉ 6.3.3. Shift, Ctrl, Alt & Normal PFKeys ΓòÉΓòÉΓòÉ The valid Shift, Ctrl, Alt, and normal PFKeys are 1 through 12. Each line has three sections. The first is a code for the key and takes the format c-f1, a-f6, f7 etc. The second section contains the characters that will be displayed in the PFKey section of the display. This can be up to 11 characters. The third section contains the command that STPOS2 will actually execute. This can be up to 31 characters. To include spaces in either of the last two fields you enter a ^ character (uppercase 6 on most keyboards). All commands are passed directly to the command processor (usually CMD.EXE) for execution unless they are internal STPOS2 commands. Information on the internal STPOS2 commands are documented in Function Keys. Below are a few examples of PFKey configuration. PF Key Menu Display Operation ------ ------------ --------- c-f5 Edit^CONFIG e^config.sys a-f10 Dir^A: dir^a:^/p s-f12 Dir^B: dir^b:^/p f7 FMOS2^/d fmos2^/d f9 New^Tree ΓòÉΓòÉΓòÉ 7. Screen coloring ΓòÉΓòÉΓòÉ Below is a chart showing where the various color definitions are used within STPOS2. To keep the chart small I show, for example, Window. This means that the profile has two options - ColorWindow and MonoWindow. If STPOS2 detects a monochrome display the Mono values will be used, otherwise the Color values will be used. Tag Description Window Color of the surround to the window which appears at the top of the screen when STPOS2 displays any messages to the user. WindowMsg Color of the characters which form the message STPOS2 wants to display. ButtonWindow Color of the surround to the menu display shown at the top of the screen Button Color of the inactive menu options shown at the top of the screen. ButtonActive Color of the active menu option shown at the top of the screen. PFKEY Color of the PFkey display shown at the bottom of the screen. HelpMsg Color of the short text displayed for each menu option at the top of the screen. MenuWindow Color of the surround to the suboption menu displayed when Copy, Move, Erase or Information is selected. Menu Color of the suboption menu items. ActiveMenu Color of the currently selected suboption menu item. Background Background color of the STPOS2 display. DirSoFar Color of the message displayed when the tree is being built which indicates the number of subdirectories that STPOS2 has found. Tree The color used to display the sub directory names. TreePath Subdirectories in the path to the current directory are displayed in this color. InvTree This color is used to highlight the currently selected subdirectory. InvTreePath This is the color used to highlight the currently selected subdirectory if it is also on the path to the current subdirectory. SelWindow Color of the window surround displayed when STPOS2 is displaying filenames. SelButtons Color of the YES NO GO QUIT messages displayed when STPOS2 is processing files selectively. SelActiveButton Color of the currently set value of YES NO GO QUIT message displayed when STPOS2 is processing files selectively. SelFilename Color used to display filenames when processing them selectively. LogoTop Color used to display the large IBM logo on the start up screen. LogoBottom Color used to display author, copyright information etc shown on the start up screen.